home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / zl2b0103.zip / ZIPLAB.DOC < prev    next >
Text File  |  1993-01-03  |  45KB  |  972 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.          
  13.          ▒▒▒▒▒▒▒▒▒▄ ▒▒▒▒▄ ▒▒▒▒▒▒▒▒▒▄ ▒▒▒▒▄       ▒▒▒▒▒▒▒▒▄  ▒▒▒▒▒▒▒▒▒▄
  14.           ▀▀▀▀▀▒▒█▀  ▒▒█▀  ▒▒█▀▀▀▒▒█  ▒▒█▀       ▒▒█▀▀▀▒▒█   ▒▒█▀▀▀▒▒█
  15.               ▒▒█▀   ▒▒█   ▒▒█   ▒▒█  ▒▒█        ▒▒█   ▒▒█   ▒▒█   ▒▒█
  16.             ▒▒▒█▀    ▒▒█   ▒▒▒▒▒▒▒▒█  ▒▒█        ▒▒▒▒▒▒▒▒█   ▒▒▒▒▒▒▒█▀
  17.            ▒▒█▀▀     ▒▒█   ▒▒█▀▀▀▀▀▀  ▒▒█        ▒▒█▀▀▀▒▒█   ▒▒█▀▀▀▒▒█
  18.           ▒▒█▀       ▒▒█   ▒▒█        ▒▒█   ▒▒▄  ▒▒█   ▒▒█   ▒▒█   ▒▒█
  19.          ▒▒▒▒▒▒▒▒▒▄ ▒▒▒▒█ ▒▒▒▒█      ▒▒▒▒▒▒▒▒▒█ ▒▒▒▒█ ▒▒▒▒█ ▒▒▒▒▒▒▒▒▒█
  20.           ▀▀▀▀▀▀▀▀▀  ▀▀▀▀  ▀▀▀▀       ▀▀▀▀▀▀▀▀▀  ▀▀▀▀  ▀▀▀▀  ▀▀▀▀▀▀▀▀▀
  21.                   ▒▒▒▒▒▒▒▒▒▄ ▒▒▒▒▄      ▒▒▒▒▄ ▒▒▒▒▄ ▒▒▒▒▒▒▒▒▄
  22.                    ▒▒█▀▀▀▒▒█  ▒▒█▀       ▒▒█▀  ▒▒█▀ ▒▒█▀▀▀▒▒█
  23.                    ▒▒█   ▒▒█  ▒▒█        ▒▒█   ▒▒█  ▒▒█    ▀▀
  24.                    ▒▒▒▒▒▒▒▒█  ▒▒█        ▒▒█   ▒▒█  ▒▒▒▒▒▒▒▒▄
  25.                    ▒▒█▀▀▀▀▀▀  ▒▒█        ▒▒█   ▒▒█    ▀▀▀▀▒▒█
  26.                    ▒▒█        ▒▒█   ▒▒▄  ▒▒█   ▒▒█  ▒▒▄   ▒▒█
  27.                   ▒▒▒▒█      ▒▒▒▒▒▒▒▒▒█  ▒▒▒▒▒▒▒▒█  ▒▒▒▒▒▒▒▒█
  28.                    ▀▀▀▀       ▀▀▀▀▀▀▀▀▀   ▀▀▀▀▀▀▀▀   ▀▀▀▀▀▀▀▀
  29.                               ▒▒▒▒▒▒▄     ▒▒▒▒▒▒▄
  30.                                ▀▀▀▒▒█     ▒▒█▀▒▒█
  31.                               ▒▒▒▒▒▒█     ▒▒█ ▒▒█
  32.                               ▒▒█▀▀▀▀     ▒▒█ ▒▒█
  33.                               ▒▒▒▒▒▒▄ ▒▒▄ ▒▒▒▒▒▒█
  34.                                ▀▀▀▀▀▀  ▀▀  ▀▀▀▀▀▀
  35.  
  36.                     Copyright (C)1989-93 by Jeffrey S. Morley
  37.                     
  38.                                
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.                                                                              
  60.                                                                              
  61.                                                                              
  62.                                                                              
  63.                                                                              
  64.                                                                              
  65.                                                                              
  66.                                                                              
  67.                                                                              
  68.                                                                              
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.                                                                              
  77.                                                                              
  78.                                                                              
  79.                                                                              
  80.                                                                              
  81.                                                                              
  82.                                                                              
  83.                                                                              
  84.                                                                              
  85.                                                                              
  86.                                                                              
  87.                                                                              
  88.                                                                              
  89. ZipLab PLUS Version 2.ß.1
  90. (C)Copyright 1989-93 by Jeffrey S. Morley
  91. January 3rd, 1993
  92.  
  93. Archive testing and maintenance program for PCBoard/ProDoor Sysops.
  94.  
  95.     
  96.  
  97.                                
  98. ##############################################################################
  99.                             Table of Contents
  100. ##############################################################################
  101.  
  102.       To jump to a section, do a search on the page number in the format:
  103.                 "Pgx" where "x" is the page number to jump to.
  104.  
  105.  
  106. Introduction to ZipLab Plus 2.0 .......................................... 1
  107.                                                                           
  108. Installation of ZipLab / Requirements .................................... 2
  109.                                                                           
  110. Installation of ZipLab / Quick Start ..................................... 3
  111.                                                                           
  112. Installation of ZipLab / A Sample Configuration File ..................... 7
  113.                                                                           
  114. Installation of ZipLab / Configuration Details ........................... 8
  115.                          I.   Conference Specific Configurations ......... 8
  116.                          II.  ZLABxxx.TCN Trashcan File(s) ............... 9
  117.                          III. ZLABxxx.CMT Comment File(s) ................ 9
  118.                          IV.  CRC.ADS .................................... 9
  119.                          V.   LST.ADS .................................... 10
  120.                          VI.  *.MSG The Message Files .................... 10
  121.                                                                           
  122. Installation of ZipLab / Usage Notes and Warnings ........................ 12
  123.                          I.   Command Line Parameters .................... 12
  124.                          II.  PCBoard's TEMP Directory ................... 12
  125.                          III. ZipLab's WORK Directory .................... 13
  126.                          IV.  Using Giftest with ZipLab .................. 13
  127.  
  128. Installation of ZipLab / Some Notes on Memory Usage ...................... 15
  129.  
  130. Installation of ZipLab / ProDoor Differences ............................. 16
  131.  
  132. ZipLab Plus Version History .............................................. 18
  133.  
  134. About ZipLab Plus and the Author ......................................... 19
  135.  
  136.  
  137.                                                                            Pg1
  138.  
  139. ##############################################################################
  140.                        INTRODUCTION TO ZIPLAB PLUS  
  141. ##############################################################################
  142.  
  143. What is ZipLab Plus?
  144.  
  145. ZipLab Plus is a shareware program which will test archived files.  In 
  146. addition, ZipLab will allow you to add .ZIP comments, strip out unwanted 
  147. members, and much, much more!  ZipLab was designed for PCBoard/ProDoor 
  148. SysOps, to test files as they are uploaded to their systems.  It is run in 
  149. the PCBTEST.BAT file which comes with PCBoard 14.5.  PCBTEST.BAT is run by 
  150. PCBoard when an upload completes.
  151.  
  152.  
  153. The following is a quick list of ZipLab's features:
  154.  
  155. Testing:  
  156. * Test for CRC errors in the archive file.
  157. * Test for imbedded archive files and if found, CRC check those too.
  158. * Test for imbedded .TD0 (Teledisk) files and if found, test with TDCHECK.
  159. * Virus SCAN archive member files, using SCAN.EXE from McAffey.
  160. * SCAN inside archive files imbedded inside another archive file.
  161. * Test .GIF files for validity if you accept that file format (Optional)
  162. * Run SCAN on files which you optionally pass without ZIP testing.
  163. * Reject programs older than a date (yyyymm) which you specify.
  164. * Uses a "trashcan" file to reject by description keywords you specify.
  165. * Will fully test "self-extracting" archives of the ZIP/ARJ/LZH formats.
  166.  
  167. Maintenance:
  168. * Remove all archive comments from the file.
  169. * Replace archive comments with your own. (Optional)
  170. * Add the contents of FILE_ID.DIZ to the archive comment.
  171. * Use special ZipLab "@" codes to include test information in the comment.
  172. * Adds the reasons to the comment on files which fail ZipLab Plus testing.
  173. * Delete unwanted BBS ads and/or other unwanted archive members as you define.
  174.   - ZipLab tests for BBS ads by FILENAME or file CRC. 
  175. * Allows you to optionally add a file to the archive.
  176.  
  177. PCBoard/ProDoor BBS specific features:
  178. * Add the resolution of .GIF files to the description (Optional)
  179. * Adds most recent archive member date to the description (Optional)
  180. * Optionally replace the description left by the user if FILE_ID.DIZ is
  181.   found in the archive file.
  182. * Will make a notation in both the CALLER file and the private DIRx 
  183.   file for the current node of any files which fail upload testing, 
  184.   including the failure reason.
  185. * Allows your users to run the TEST command in PCBoard to test files, 
  186.   but ZipLab will not remove the file unless it fails CRC or virus 
  187.   checking. You will be notified via the node's CALLER file of 
  188.   archives which fail PCBoard's TEST command, and why.
  189. * Takes the phone "offhook" if the user hangs up before/during testing.
  190. * Sends a mail message to the user letting him know why a file was
  191.   rejected, and to both the user and the Sysop when a virus is found.
  192. * Allows full conference specific configurations.
  193.   
  194. General:
  195. * Run the full range of tests on .ZIP, .LHZ and .ARJ archive formats
  196. * Works on a PCBoard/ProDoor BBS in both online and local modes.
  197. * Works with both the old and new versions of PKZip.
  198.  
  199.   
  200.                                                                            Pg2
  201.  
  202. ##############################################################################
  203.                          ZIPLAB PLUS REQUIREMENTS                 
  204. ##############################################################################
  205.  
  206.  ! YOU MUST BE RUNNING PCBOARD VERSION 14.5(a) OR PRODOOR VERSION 3.44 !
  207.  
  208. You must have the following programs.  Several are included in the ZipLab 
  209. Plus archive, but registration of ZipLab DOES NOT include registration of 
  210. any of these products.  Please SUPPORT SHAREWARE and register these products 
  211. with their respective authors.
  212.  
  213. PKZIP.EXE   - Phil Katz's archive create program (version 1.01 or 1.93)
  214. PKUNZIP.EXE - Phil Katz's archive extract program (version 1.01 or 1.93)
  215. LHA.EXE     - Yoshi's archive program (version 2.13 +)
  216. ARJ.EXE     - Robert Jung's archive program (version 3.00 +)
  217. SCAN.EXE    - McAffey's virus detection program (any version)
  218. RECOM.EXE   - Mike Loewen's ZIP file comment remover
  219. GIFTEST.EXE - Dave Navarro's .GIF file tester (optional)
  220. TDCHECK.EXE - .TD0 (Teledisk) checker from SyDex (optional)
  221.  
  222. VBDTR10.EXE - RunTime module for Visual Basic for DOS.  You will need
  223.               this module in a directory in your DOS PATH to run
  224.               ZSET.EXE.  Free from Microsoft Inc.
  225.  
  226. Programs I have written and which are part of the ZipLab Plus package.
  227.  
  228. DELF.COM    - A version of DEL with no "Are you sure?" prompt.
  229. ZLSCR.COM   - A little utility called by ZipLab to help handle the
  230.               local screen during testing (Based on ProNS.COM by
  231.               Sam Smith).
  232. ZCRC.EXE    - A small utility to get file CRC values for placement in your
  233.               ADS.CRC file.
  234. ZLAB.EXE    - The ZipLab Plus executable program.
  235. ZSET.EXE    - The ZipLab Plus setup/configuration maintenance program.
  236.  
  237.  
  238.                                                                            Pg3
  239.  
  240. ##############################################################################
  241.                                QUICK START 
  242. ##############################################################################
  243.  
  244. * ZipLab does a LOT of things.  It is a complicated program, but a breeze
  245.   to set up and run... IF you follow the directions and read this entire
  246.   documentation.  Print this document and follow it step by step.  You
  247.   can't miss.
  248.   
  249. * Create a directory to hold ZLAB.EXE, the sample ZLAB000.CFG, 
  250.   ZLAB000.TCN, CRC.ADS, LST.ADS, *.MSG, ZLAB000.CMT and ZSET.EXE 
  251.   files.  This directory should be in your DOS PATH.  All ZipLab files 
  252.   can be shared by multiple nodes.  Node specific configurations are 
  253.   not required.  Let's assume you use C:\ZIPLAB for now.
  254.  
  255. * UnZIP the enclosed supplemental utilities into directories in your DOS 
  256.   PATH. Make note of where you put them, you will need this information 
  257.   later.  Make sure VBDRT10.EXE is in your DOS PATH.
  258.  
  259. * Run "ZSET.EXE ZLAB000.CFG".  ZSET will then start with the default 
  260.   configuration, ZLAB000.CFG, which you should modify to meet your system's 
  261.   needs.  The "000" in the config name is conference specific.  The default 
  262.   is for conference "0", the "Main Board". More later on how to create 
  263.   conference specific configurations. for now, ZipLab will default to 
  264.   looking for ZLAB000.CFG when run from any conference.
  265.   
  266. * Modify the following information for your system ,in ZLAB000.CFG:
  267.  
  268.      1  -  The type of modem HANDSHAKE you desire.  This can be 
  269.            0, 1, 2 or 3.  0=none, 1=XON/XOFF, 2=CTS, 3=CTS & XON/XOFF
  270.            (Use 2 or 3 with an error correcting modem...)
  271.            DEFAULT = 3
  272.         
  273.      2  -  The name of your BBS system.  43 characters maximum.
  274.            DEFAULT = THE INTERCONNECT BBS
  275.            
  276.      3  -  The DRIVE and PATH to the directory where rejects will be
  277.            placed pending manual sysop inspection.  This can be a 
  278.            common directory on multiple node systems, but SHOULD be
  279.            an empty (existing) directory dedicated to this purpose.
  280.            I recommend "d:\FAIL" or "d:\HOLD" as likely names.
  281.            DEFAULT = C:\FAIL
  282.            
  283.      4  -  The full DRIVE\PATH\FILENAME of your ZLAB000.TCN (trashcan)
  284.            file.  The filename need not follow the ZLABxxx.ext format,
  285.            but it will make conference specific work much easier later.
  286.            DEFAULT = C:\ZIPLAB\ZLAB000.TCN
  287.            
  288.      5  -  The date (yyyymm) which will be the minimum accepted year.  ZIPs
  289.            containing files older than this will be rejected.  Example:
  290.            199001 would mean any file older than January, 1990 would fail.
  291.            DEFAULT = 199001
  292.         
  293.      6  -  A "Y" if you wish to replace the description left by the user
  294.            with the contents of FILE_ID.DIZ (if found in the archive).
  295.            A "N" if you do not wish to make use of this feature.
  296.            DEFAULT = Y   
  297.  
  298.                                                                            Pg4
  299.      
  300.      7  -  A "Y" if you wish the "recent date" notation added to the file
  301.            descriptions.  A "N" if you do not wish this addition.
  302.            DEFAULT = Y
  303.         
  304.      8  -  A "Y" if you wish the "number of archive member files" notation
  305.            added to the file descriptions.  A "N" if you do not.
  306.            DEFAULT = Y
  307.         
  308.      9  -  A "Y" if you wish ZipLab to send a mail message to the user
  309.            when a file fails testing.  A "N" if not.
  310.            DEFAULT = Y
  311.         
  312.      10 -  A "Y" if you wish the sysop to also receive a mail message in
  313.            the instance of a virus detection.  A "N" if you do not. 
  314.            DEFAULT = Y
  315.         
  316.      11 -  The DRIVE\PATH\ to the directory which will hold the .MSG files.
  317.            These are the mail messages sent to the user/sysop on failure.
  318.            Please put a "\" at the end of the path.
  319.            DEFAULT = C:\ZIPLAB\
  320.            
  321.      11 -  The full DRIVE\PATH\FILENAME of a zip comment to add.  Again,
  322.            it is recommended that the name ZLAB000.CMT be used for
  323.            consistancy.  Specify "NONE" if you don't want to add a comment.
  324.            DEFAULT = C:\ZIPLAB\ZLAB000.CMT
  325.         
  326.      12 -  A "Y" if ZipLab should add the contents of FILE_ID.DIZ (if
  327.            found) to the bottom of the zip comment.  "N" to disable.
  328.            DEFAULT = Y
  329.         
  330.      13 -  The fully qualified filename of a file which you may wish to
  331.            add to the .ZIP, or "NONE" (please!) if you can refrain from
  332.            this practice. Once again, ZLAB000.ADD will make sense later.
  333.            DEFAULT = NONE
  334.         
  335.      14 -  Full DRIVE:\PATH\FILENAME of PKZIP.EXE.
  336.            DEFAULT = C:\UTILITY\PKZIP.EXE
  337.         
  338.      15 -  Full DRIVE:\PATH\FILENAME of PKUNZIP.EXE.
  339.            DEFAULT = C:\UTILITY\PKUNZIP.EXE
  340.         
  341.      16 -  Full DRIVE:\PATH\FILENAME of LHA.EXE.
  342.            DEFAULT = C:\UTILITY\LHA.EXE
  343.         
  344.      17 -  Full DRIVE:\PATH\FILENAME of ARJ.EXE.
  345.            DEFAULT = C:\UTILITY\ARJ.EXE
  346.  
  347.      18 -  Full DRIVE:\PATH\FILENAME of TDCHECK.EXE.
  348.            (or "NONE" if not using)
  349.            DEFAULT = C:\UTILITY\TDCHECK.EXE
  350.         
  351.      19 -  Full DRIVE:\PATH\FILENAME of SCAN.EXE.
  352.            DEFAULT = C:\UTILITY\SCAN.EXE
  353.         
  354.      20 -  Full DRIVE:\PATH\FILENAME of RECOM.EXE.
  355.            DEFAULT = C:\UTILITY\RECOM.EXE
  356.  
  357.                                                                            Pg5
  358.         
  359.      21 -  Full DRIVE:=PATH\FILENAME of DELF.COM
  360.            DEFAULT = C:\UTILITY\DELF.EXE
  361.         
  362.      22 -  Full DRIVE:\PATH\FILENAME of GIFTEST.EXE
  363.            (or "NONE" if not using)   
  364.            DEFAULT = C:\UTILITY\GIFTEST.EXE
  365.         
  366.      23 -  Command line PARAMETERS you wish to pass to GIFTEST.EXE
  367.            Please refer to the documentation for GIFTEST for details!
  368.            Just enter "NONE" if you do not desire to pass parameters.
  369.            DEFAULT = NONE
  370.         
  371.      24 -  A list, all on one line, (separated by ";" - EXE;TXT;GIF) 
  372.            Which will be passed without normal ZIP testing.  SCAN and 
  373.            date checking will still be performed on these files.  Any 
  374.            extensions other than ZIP/ARJ/LZH which do not appear in 
  375.            this list will be rejected by the process. If GIF appears 
  376.            in this list, GIFTEST will be used to test the integrity of 
  377.            the GIF file. If you enter a "*" as one of the extentions, 
  378.            then ALL files will be passed through, with non-archived 
  379.            files being SCAN'd and date checked only. "NONE" in this
  380.            position will only allow ZIP/ARJ/LZH files to pass.
  381.            DEFAULT = GIF;EXE;PCX
  382.         
  383.      25 -  The full DRIVE/PATH/FILENAME of a text file containing the 
  384.            file CRC for files you wish removed before posting the 
  385.            archive.  This file can be called anything, but LST.ADS 
  386.            works for me. You can use the included ZCRC.EXE to help 
  387.            maintain this file.  More on the use of ZCRC.EXE later.
  388.            DEFAULT = C:\ZIPLAB\CRC.ADS
  389.         
  390.      26 -  The full DRIVE/PATH/FILENAME of a text file containing the 
  391.            NAMES (one on each line) of files you wish removed before 
  392.            posting the archive. This file can be called anything you 
  393.            wish, I suggest CRC.ADS.  Any files listed in this text 
  394.            file which exist in the uploaded archive will be removed.
  395.            DEFAULT = C:\ZIPLAB\LST.ADS
  396.         
  397. * Click on the "SAVE" button in ZSET.EXE, and save under the ZLAB000.CFG
  398.   filename.
  399.   
  400. * Edit your existing PCBTEST.BAT file, and delete the whole thing except 
  401.   for two lines:
  402.   
  403.   Sample PCBTEST.BAT file:
  404.   
  405.   @ECHO OFF
  406.   C:\ZIPLAB\ZLAB.EXE %1 C:\PCB C:\ZIPLAB %2
  407.                      ^1 ^2     ^3        ^4
  408.   
  409.   1)  %1         PCBoard will populate this with the DRIVE\PATH\FILE to test.
  410.   2)  C:\PCB     The PCBoard "home" directory for the node.
  411.   3)  C:\ZIPLAB  The directory containing your ZLABxxx.CFG file(s).
  412.   4)  %2         PCBoard will populate this with TEST if a user is running
  413.                  the TEST command on the board.  You can also pass LOCAL 
  414.                  to this parameter to run ZipLab from DOS.
  415.  
  416.                                                                            Pg6
  417.                             
  418. * Note!  Although ZipLab can share its configuration files, it should be run 
  419.   FROM the PCBoard "home" directory of each node.  Do not change directories 
  420.   in PCBTEST.BAT to your "ZIPLAB" directory.
  421.  
  422. * That's it... Now when PCBTEST.BAT is run by PCBoard, it will pass command 
  423.   over to ZLAB.EXE with the parameter containing the path and name of the 
  424.   file to be tested.  ZLAB will check out the file, placing any rejects in 
  425.   the holding directory you specified in the ZSET process above.  
  426.  
  427.  
  428.                                                                            Pg7
  429.  
  430. ##############################################################################
  431.                        A SAMPLE ZLAB000.CFG FILE
  432. ##############################################################################
  433.  
  434.                      2                                      
  435.                      The Interconnect Bulletin Board System 
  436.                      C:\FAIL                                
  437.                      C:\ZIPLAB\ZLAB000.TCN                  
  438.                      199001                                 
  439.                      Y                                      
  440.                      Y                                      
  441.                      Y                                      
  442.                      Y                                      
  443.                      Y                                      
  444.                      C:\ZIPLAB\ZLAB000.CMT                  
  445.                      Y                                      
  446.                      NONE                                   
  447.                      C:\UTILITY\PKZIP.EXE                   
  448.                      C:\UTILITY\PKUNZIP.EXE                 
  449.                      C:\UTILITY\LHA.EXE                     
  450.                      C:\UTILITY\ARJ.EXE                     
  451.                      C:\UTILITY\TDCHECK.EXE                 
  452.                      C:\UTILITY\SCAN.EXE                    
  453.                      C:\UTILITY\RECOM.EXE                   
  454.                      C:\UTILITY\DELF.COM                    
  455.                      C:\UTILITY\GIFTEST.EXE                 
  456.                      /B:2 /F:UPDESC.2                       
  457.                      GIF;EXE;PCX                            
  458.                      C:\ZIPLAB\CRC.ADS                      
  459.                      C:\ZIPLAB\LST.ADS                      
  460.  
  461.  
  462.                                                                            Pg8         
  463.  
  464. ##############################################################################
  465.                            CONFIGURATION DETAILS       
  466. ##############################################################################
  467.  
  468. I.   Conference Specific Configurations
  469.  
  470. You MUST at least have created a file name ZLAB000.CFG for ZipLab Plus to 
  471. operate.  The "000" tells ZipLab that this is the configuration file for the 
  472. Main Board Conference, but is also the default for any conferences that do 
  473. not have specific configuration files. 
  474.  
  475. To create a configuration for another conference (let's use your "GAMES" 
  476. conference, number "5", as an example), run ZSET ZLAB000.CFG to bring in 
  477. your default configuration file, and then modify the file to be specific to 
  478. your Games Conference.
  479.  
  480. You can change just about every configuration item to be specific to the 
  481. Games conference.  Some things you might want to change are:
  482.  
  483. * The "Board Name" field - Maybe It will say "Joes BBS - Games Conference"
  484. * The name of your .TCN (trashcan) file.  You may want to exclude more
  485.   (or less) types of files from this conference.  Just call the file
  486.   ZLAB005.TCN.
  487. * The "Date Limit" field.  Maybe you want only the LATEST games.
  488. * The "Zip Comment" field.  Have a conference specific .ZIP comment by
  489.   changing the name to ZLAB005.CMT.
  490. * The use (or non-use) of GIFTEST.EXE, and the acceptance of .GIF files.  
  491.  
  492. Once you have modified the configuration to your satisfaction, just click on 
  493. "SAVE".  You will be presented with a "windows-ish" file save dialog window.  
  494. Change the name of the file to ZLAB005.CFG in the input field labeled "File 
  495. will be saved as:", and click on "OK"
  496.  
  497. (To edit this configuration file at a later time, just run ZSET.EXE with the 
  498. name of the configuration file as a parameter.  "ZSET ZLAB005.CFG")
  499.  
  500. Make further changes for other conferences you wish to set up, and save 
  501. under their respective names(up to 999 conferences).  When done, exit 
  502. ZSET.EXE.  
  503.  
  504. * Note!  Be sure that any files like ZLAB005.TCN or ZLAB005.CMT that you 
  505.   specify actually do exist!  You can create them before or after you run 
  506.   ZSET.EXE, but certainly before you run ZipLab Plus (unless you want to 
  507.   test my error handling system <g>).   
  508.  
  509.  
  510. II.  ZLABxxx.TCN  The "trashcan" file(s)
  511.  
  512. This file holds text key-words or key-phrases which are used to reject
  513. files based on either the filename or contents of the file description.
  514. If you for instance did not want "adult" .GIF files uploaded to your 
  515. system, but did want to allow other .GIF file uploads, you might put the
  516. following lines in ZLAB000.TCN:
  517.  
  518. ADULT
  519. X-RATED  
  520. "X RATED"
  521. MARGARINE
  522. "KITCHEN TABLE"
  523.  
  524.  
  525.                                                                            Pg9
  526.  
  527. Or whatever you feel would allow ZipLab to identify the kind of files you 
  528. have in mind, without being so generic as to cause perfectly acceptable 
  529. files to fail.
  530.  
  531. ZipLab Plus will test the filename, user supplied description, and the 
  532. contents of FILE_ID.DIZ (if found) against this list, and will reject any 
  533. files which contain these "trashcan" words/phrases.
  534.  
  535. * Note!  To imbedd "white space" either in, before, or after an entry, use 
  536.   the QUOTE (") character to surround the phrase or word. For instance, if 
  537.   you wanted to exclude files with the word "WIN" in them, you should use
  538.   " WIN " so that things like "TWIN" or "WINNER" don't also fail.
  539.  
  540.   
  541. III. ZLAB000.CMT  The "comment" file(s)
  542.  
  543. This is a text file which will be added as a .ZIP (or .ARJ) comment to
  544. the archive file.  As you can see from the filename format, you can
  545. certainly have a different comment file for each conference if you so
  546. desire.
  547.  
  548. This file can say anything you want.  I have also included some ZIPLAB-
  549. specific "@ZCODES" which can be imbedded in the text to add information
  550. which ZipLab Plus will provide at run-time.  You may NOT use PCBoard's
  551. "@-Codes", only the ones that ZipLab Plus supplies:
  552.  
  553. @ZCODE      MEANING              FORMAT / ADDITIONAL DESCRIPTION
  554.  
  555. @F_N@       File Name            "filename.ext"
  556. @A_T@       Archive Type         ".ZIP", ".ARJ", or ".LZH"
  557. @D_T@       Date Tested          "mm/dd/yyyy"
  558. @T_T@       Time Tested          "hh:mm:ss"
  559. @B_N@       Board Name           from ZLABxxx.CFG
  560. @U_N@       User Name            "firstname lastname"
  561. @N_O_F@     Number of Files      count of files in archive
  562. @N_F@       Newest File          "mm/dd/yyyy"
  563. @O_F@       Oldest File          "mm/dd/yyyy"
  564. @P_F_S@     Pass-Fail Status     "passed" or "failed"
  565. @R_F@       Reason for Failure   "CRC checking" , "Virus checking" etc...
  566. @T_C_T@     Trash Can Text       Text which failed .TCN checking - if any.
  567. @V_N@       Version Number       Version of ZipLab Plus ("2.0")
  568. @D_L@       Date Limit           "mm/dd/yyyy"
  569. @F_I_F@     FILE_ID.DIZ Found    "found" or "not found"
  570. @N_N@       Node Number          BBS node number
  571. @C_N@       Conference Number    conference the user is in (as a number)
  572.  
  573. * Note!  You may also use the word "ZIPLAB" in this field in ZLABxxx.CFG, 
  574.   and ZipLab will create a comment for you, with much of the above 
  575.   information. As always, you may also use "NONE", and ZipLab will not add 
  576.   any comment at all.
  577.  
  578.  
  579. IV.  CRC.ADS
  580.  
  581. This file will contain the file CRC-32 values (and names) of files which
  582. you wish removed from the archive prior to posting.  The format of the
  583. file is:
  584.  
  585. 00000000,filename.ext
  586.  
  587.  
  588.                                                                           Pg10
  589.  
  590. Where "00000000" is the file's CRC-32, and filename.ext is one of the 
  591. names by which the file is known.  The filename is not optional, but
  592. can really be anything, as ZipLab could care less what a file is called.
  593. If it matches on the CRC-32 value, it WILL be removed.
  594.  
  595. You will want to maintain your CRC.ADS file using the ZCRC.EXE file which is 
  596. included in the ZipLab Plus archive.  Just type:
  597.  
  598. "ZCRC [d:\path\]CRC.ADS [d:\path\]filename.ext" 
  599.  
  600. and ZCRC.EXE will place the proper information for the filename you replace
  601. "filename.ext" with at the bottom of the CRC.ADS file.
  602.  
  603. As always, a "NONE" in the ZLABxxx.CFG file in this position will cause 
  604. ZipLab Plus to skip this process.
  605.  
  606. * Note!  It is certainly acceptable to have different "CRC.ADS" files for 
  607. different confereneces, and you could use the "ZLABxxx.ADS" convention if 
  608. you wish.  I find that trying to maintain multiple versions of this file to 
  609. be a fair amount of trouble however, and don't particuarly recommend it.
  610.  
  611.  
  612. V.   LST.ADS
  613.  
  614. This is a text file (one on each line) containing only the names of files
  615. you wish removed without testing.  The difference between this file and
  616. the CRC.ADS file is that you can test for a particular file name, and it
  617. will remove it even if the person adding the file changes the contents 
  618. from time to time.  This file also supports "wildcards", so you can test
  619. for those names where "special" characters (above 126 ASCII) have been
  620. used to create a filename, by masking out those characters.
  621.  
  622. As an example, you could test for a BBS ad called "S£ïMΣ.Pïτ" by adding
  623. "S??M?.P??" as an entry in LST.ADS (of course, "SIMMS.PAS" would fail
  624. as well, so be careful how you use wildcards.).
  625.  
  626. Use "NONE" in the field in ZLABxxx.CFG to disable this feature.
  627.  
  628. * Note!  This file can contain up to 100 lines in version 2.0.
  629.  
  630.  
  631. VI.  *.MSG  The mail message files
  632.  
  633. The mail message files are text files (the @ZCodes can be used, and in 
  634. fact you could imbedd PCBoard's @Codes as well, they will just get passed 
  635. through to the message and handled by PCBoard when the user reads the 
  636. message.), which will constitute mail messages sent to the user when a file 
  637. fails. This can be used to tell the user the reason for the rejection, to 
  638. remind him of rules you may have about types of file you accept, or to 
  639. reassure him that you still love him even though his file did have a CRC 
  640. error <g>.
  641.  
  642. Remember when modifying or creating these files, that there are limits
  643. on mail messages in PCBoard.  Also, be sure to leave enough room for
  644. any @ZCodes to expand to actual values without running longer than
  645. 78 characters per line.
  646.  
  647. The files MUST have the names below, and samples of all the files are
  648. included in this archive.  These files should be in a central location,
  649. perhaps the C:\ZIPLAB directory where you have the .TCN, .CMT and other
  650. ZipLab files is best.  One of the entries in the ZLABxxx.CFG files will
  651. let you tell ZipLab where to find these files.
  652.  
  653.                                                                           Pg11
  654.  
  655. The files (and failure reasons) that ZipLab Plus uses are:
  656.  
  657. NAME OF FILE      REASON FOR FAILURE 
  658. ------------      ------------------
  659. OLDDATE.MSG       Failed date limit checking
  660. FILECRC.MSG       Failed CRC or -AV checking
  661. IMBEDCRC.MSG      An imbedded archive failed CRC or -AV checking
  662. TRASHCAN.MSG      .TCN (Trashcan) text was found in the description
  663. BADTD0.MSG        A Teledisk format (.TD0) file failed TDCHECK
  664. USRVIRUS.MSG      Message sent to USER on virus detection
  665. SYSVIRUS.MSG      Message sent to SYSOP on virus detection
  666. UNACCEPT.MSG      An unaccepted file format was uploaded
  667. GIFFAIL.MSG       A .GIF file failed GIFTEST
  668.  
  669. DO NOT RENAME THESE FILES!
  670.  
  671.  
  672.  
  673.                                                                           Pg12
  674.  
  675. ##############################################################################
  676.                          USAGE NOTES AND WARNINGS
  677. ##############################################################################
  678.  
  679. I.   Command line parameters -
  680.  
  681. ZLAB.EXE has the following commmand syntax:
  682.  
  683. ZLAB d:\path\filename d:\pcbpath d:\cfgpath [LOCAL|TEST]
  684.  
  685. d:\path\filename - The file to test, normally passed by PCBoard.
  686. d:\pcbpath       - The "home" PCBoard directory for this node.
  687. d:\cfgpath       - The directory containing your ZLABxxx.CFG files.
  688. LOCAL            - Causes ZipLab to function without any output to the 
  689.                    comm port.  Use this for testing files already on your 
  690.                    hard drive, or that you have downloaded yourself and 
  691.                    wish to post.  No changes will be made to any DIRx 
  692.                    files.
  693. TEST             - PCBoard will pass this as %2 if you are using the TEST 
  694.                    command inside PCBoard.  Files will only be moved to 
  695.                    the "hold" directory if they fail CRC or Virus 
  696.                    checking.  No changes will be made to any DIRx files.  
  697.                    Normal comm port output.                   
  698.  
  699. ZSET.EXE has the following command syntax:
  700.  
  701. ZSET [d:\path\][configname.cfg]
  702.  
  703. [d:\path\]       - If you are not in the directory containing the .CFG 
  704.                    files for the node, you must specify the exact location 
  705.                    of the config file you wish to modify.
  706. [configname.ext] - The name of the ZLABxxx.CFG file you wish to load. This 
  707.                    MUST be in the "ZLABxxx.CFG" format, with the "xxx" 
  708.                    replaced with the conference specific .CFG file you 
  709.                    wish to modify.  
  710.  {default}       - If you do not specify a file on the command line, 
  711.                    ZSET.EXE will create a file called "NONAME.CFG" in your 
  712.                    current directory.  After you have modified the default 
  713.                    settings to your specifications, be sure to save the 
  714.                    file under a proper ZLABxxx.CFG filename for the 
  715.                    conference you are setting up, and in the proper 
  716.                    location.  NONAME.CFG will be deleted when you exit.
  717.                                                        
  718.  
  719. II.  PCBoard's "TEMP" directory -
  720.  
  721. Line 179 of your PCBOARD.DAT file (maintained with PCBSETUP.EXE) is 
  722. critical to the operation of ZipLab Plus.  This is the "temporary" 
  723. directory in which (among other things) PCBoard holds the file 
  724. descriptions for uploads before they are actually posted.  This directory 
  725. MUST exist, and be EMPTY (don't use your root directory of your boot drive 
  726. like a couple of people have in the past!).  PCBSETUP WILL NOT CREATE THIS 
  727. DIRECTORY WHEN YOU EXIT, even though it does create just about every other 
  728. directory you specify if it doesn't exist.  This is just a quirk of 
  729. PCBSETUP, and it is up to you to be SURE this directory is both in 
  730. PCBOARD.DAT and that it exists.
  731.  
  732.  
  733.                                                                           Pg13
  734.   
  735. III. ZipLab Plus' "WORK" directory -
  736.  
  737. This directory is created (and removed) each time ZipLab Plus runs.  It
  738. is used to hold unzipped files and other temporary files while ZipLab is
  739. running.  By default, ZipLab creates a new directory under your current
  740. one (your PCBoard root directory in most cases) called .\ZLAB.DIR, which
  741. it removes when done.  If you want to redirect this to another drive
  742. (say a RAM drive for additional speed), set an environment variable 
  743. called "ZIPLAB" to the drive and directory name you wish.
  744.  
  745. SET ZIPLAB=E:\ZWORK
  746.  
  747. * Note!  This is another case where flexiblity is great, but can be 
  748.   dangerous if you don't pay attention.  Setting ZIPLAB= to oh, say the 
  749.   root directory of your boot drive - would have results which may cause 
  750.   you to think poorly of my program (and I of your mental capacity).
  751.  
  752.  
  753. IV.  Using GIFTEST with ZipLab
  754.  
  755. ZipLab does not pass any default parameters at all to Giftest.Exe.  You 
  756. will need to do that by specifing the parameters on the line in 
  757. ZLAB000.CFG which is for this purpose.  If all you want to do is test .GIF 
  758. files for integrity, and make sure they pass some standard of resolution 
  759. and colors that you set, This is all pretty easy.  Just use:
  760.      
  761. /M:640X480X256     (replace the resolution and colors with yours)
  762.      
  763. Giftest will work just fine with a simple parameter line like this. If you 
  764. want to insert the resolution/colors into the PCBoard description, it gets 
  765. a bit tricky... The first thing you have to tell Giftest is what board 
  766. type you are running, so follow the parms above (no spaces) with:
  767.  
  768. /B:x   (Where "x" is a "1" for ProDoor or a "2" for PCBoard)
  769.  
  770. Now we need to tell Giftest where the description file is for the node you 
  771. are on.  This is the tricky part... To do this, you are GOING TO HAVE TO 
  772. HAVE A DIFFERENT ZLAB000.CFG FILE FOR EACH NODE. Follow the parms above 
  773. (no spaces) with:
  774.  
  775. /F:drive:\path\description.file 
  776.  
  777. Now in PCBoard, that is going to be the drive and directory which is 
  778. specified on line 179 of PCBoard.Dat, and then the filename of UPDESC.x 
  779. where "x" is replaced with the node number for the current node.  (just 
  780. use UPDESC without an extension if you are not running nodes)
  781.  
  782. In Prodoor, the path will be your PCB home directory FOR THAT NODE, and 
  783. the filename will be $DOOR.NAM.
  784.  
  785. Please do not use the "/E" parameter on the Giftest parameter line. ZipLab 
  786. will take care of the file if it fails, there is no need to have Giftest 
  787. erase the file, and it will only confuse ZipLab.
  788.                                                   
  789. You will then have to do this for each node you have, and they will have
  790. to be in different directories.  I recommend that you use something like
  791. C:\ZIPLAB\NODE1 as a directory to hold your node 1 .CFG files.  All the
  792. other files for ZipLab with the exception of the ZLABxxx.CFG files can
  793. still be shared and can reside in C:\ZIPLAB or wherever you have specified
  794. in the .CFG files.
  795.  
  796.                                                                          Pg14
  797. Then change your ZLAB command line in PCBTEST.BAT to something this for
  798. node 1:
  799.  
  800. PCBoard:
  801. ZLAB %1 %PCBDRIVE%%PCBDIR% C:\ZIPLAB\NODE1 %2
  802.  
  803. ProDoor:
  804. ZLAB %TARGET% %pcbdrive%%pcbdir% C:\ZIPLAB\NODE1
  805.  
  806. The other option is to put the ZLABxxx.CFG files in the home PCB directory
  807. for each node, and then the command line is simple:
  808.  
  809. PCBoard:
  810. ZLAB %1 %PCBDRIVE%%PCBDIR% %PCBDRIVE%%PCBDIR% %2
  811.  
  812. ProDoor:
  813. ZLAB %TARGET% %pcbdrive%%pcbdir% %pcbdrive%%pcbdir% 
  814.      
  815.  
  816.                                                                           Pg15
  817.  
  818. ##############################################################################
  819.                         SOME NOTES ON MEMORY USAGE
  820. ##############################################################################
  821.  
  822. * NOTE!  Since PCBoard is SHELLING out to run PCBTEST.BAT, there is 
  823.   limited memory available for ZLAB.EXE.  If you are running in a 
  824.   multitasking or other memory constrained situation, ZLAB may not work! 
  825.   You should have at least 250k free memory when shelled out of PCBoard.  
  826.   If this is a problem, you may want to consider the VAROOM (overlay) 
  827.   version of PCBoard, which runs in considerably less memory than the 
  828.   standard PCB.EXE.
  829.   
  830.   The other option is to run PCBoard with the SET PCB = /SWAP environment 
  831.   variable.  This will cause PCBoard to "swap" its code to the best 
  832.   available storage (EMS, DISK) whenever a SHELL function (external 
  833.   protocol, viewfile, and even DOORS if you have the SHELL column in 
  834.   DOORS.DAT(LST) set to "Y") is called.  This method will cause a slight 
  835.   delay when SHELLING, but will provide the largest amount of available 
  836.   DOS memory for your external code.
  837.  
  838.  
  839.                                                                           Pg16
  840.  
  841. ##############################################################################
  842.                            PRODOOR DIFFERENCES         
  843. ##############################################################################
  844.  
  845. *  PRODOOR SYSOPS -
  846.    You will need to set up your PROUTEST.BAT file like this:
  847.                 
  848.    
  849.    @echo off
  850.    rem -- process test uploads request - for ProDOOR 3.44
  851.    rem -- %1-logfile, %2-testdir, %3-comport
  852.    
  853.    rem -- test each uploaded file individually
  854.    proecho %3 ~~Testing uploads.  Please wait...~
  855.    
  856.    SET PCBDOOR=PRODOOR
  857.    for %f in (%2\*.*) do COMMAND /c ZLAB %f d:\pcbpath d:\path\cfgpath 
  858.    SET PCBDOOR=
  859.    
  860.    :end
  861.  
  862.    Be sure you have enough ENVIRONMENT space to set up the PCBDOOR variable.  
  863.    If you are using DesqView, you may want to set PCBDOOR=xxxxxxx in your 
  864.    AUTOEXEC.BAT to be sure enough room is allocated in your DesqView 
  865.    partitions for this variable.  The x's will be replaced by PRODOOR when 
  866.    PROUTEST.BAT is executed.  I need this variable set to "PRODOOR", or ZLAB 
  867.    won't know you are running out of ProDoor.  You don't want to leave it set 
  868.    to PRODOOR though, since this could confuse things for other 
  869.    doors/processes. Thus the "SET PCBDOOR=" line.  ZipLab will fully work with 
  870.    ProDoor, including display/modification of the file descriptions.
  871.    
  872.              
  873. * Note!   Sam Smith has included an example PROUTEST.BAT/PROUT1.BAT 
  874.           with ProDoor, which as of this writing shows how to use 
  875.           ZipLab Plus 1.9c to do testing.  This WILL NOT work with 
  876.           ZipLab Plus 2.0, as the command line parameters for ZipLab 
  877.           have changed.
  878.           
  879.           Here is the relevant portion of PROUT1.BAT (called by
  880.           PROUTEST.BAT).
  881.           
  882.   rem -- test archives using ziplab plus by jeffrey s. morley
  883.   rem -- ziplab plus tests zip, arj, and lzh files
  884.   :test
  885.   addbidir %pcbdrive%%pcbdir%\$door.nam %TARGET%
  886.  
  887.   tm /l ptest %TARGET% u:\prod\ptest%PCBNODE%.cfg >>u:\prod\test%PCBNODE%.log
  888.   set PCBDOOR=PRODOOR
  889.   set ZIPLAB=T:\PTEST%PCBNODE%
  890.   cdto t:\scr%PCBNODE%
  891. ! ptest %TARGET% u:\prod\ptest%PCBNODE%.cfg
  892.   cdto u:\prod
  893.   set PCBDOOR=
  894.   if not exist %TARGET% del %dszlog%
  895.   if not exist %TARGET% goto end
  896.  
  897.   :end
  898.  
  899.  
  900.                                                                           Pg17
  901.  
  902.           The line I have marked with an "!" is the command line for
  903.           ZLAB.EXE and MUST be changed to read:
  904.           
  905.           zlab %TARGET% %pcbdrive%%pcbdir% u:\prod
  906.           
  907.           if you are going to use the sample PROUTEST/PROUT1 batch
  908.           files from Sam.
  909.           
  910.        
  911.                
  912.                                                                           Pg18
  913.  
  914. ##############################################################################
  915.                      VERSION HISTORY (NEWEST TO OLDEST)
  916. ##############################################################################
  917.  
  918.                          ZipLab Plus Beta 2.ß.1
  919.                         Version 2.0 beta version
  920.                            December 27, 1992
  921.                            
  922. First release of version 2.0 to wide-area beta.  Please, Please! read the
  923. documentation carefully, as well as the BETA.DOC file included.  Significant
  924. changes have been made to every part of ZipLab Plus, and none of your old
  925. executables or configurations will work without replacement or modification.
  926.                            
  927.  
  928.  
  929.                                                                           Pg19
  930.  
  931. ##############################################################################
  932.                       ABOUT ZIPLAB PLUS AND THE AUTHOR
  933. ##############################################################################
  934.    
  935. ZipLab Plus started out as a somewhat complicated batch file sometime in 
  936. 1989.  We all had been running PKUNZIP -t against uploads for some time, but 
  937. I wanted a batch file that would do a bit more, like use SCAN to test for 
  938. virus infection, reject old archives, and strip out .ZIP comments.  I also 
  939. wanted to present an interesting interface to the user, letting him/her 
  940. know what was going on in the program.
  941.  
  942. As the functions in ZipLab increased and became more complicated, it took 
  943. longer and longer to test files in the somewhat inefficient batch file 
  944. environment.  I then decided to port the program over to my programming
  945. language of choice (or at least default) QuickBasic 4.5.           
  946.  
  947. At this time I decided to make the program "shareware" to compensate for
  948. at least some of the time I was spending on the program.  I must say that
  949. ZipLab Plus has exceeded my expectations as a shareware offering, and I
  950. am grateful (and a little stunned) for the response by Sysops who have
  951. registered the program.  I had always heard figures like "only 5% or less
  952. of those who use shareware register", but if this is true then 10's of 
  953. thousands of sysops are currently using ZipLab Plus.  I don't believe that
  954. to be the case, and am instead inclined to believe that sysops, unlike
  955. doctors and lawyers, are NOT their own worst customers.
  956.  
  957. This program was written in QuickBasic 4.5, with some help from Hammerly 
  958. Computing's ProBas 4.01 and various home-grown assembly and C routines.  I 
  959. have included a few utilities which ZLAB will use in the course of testing.  
  960. These utilities are the property of the authors, and you are strongly 
  961. requested to register them if you continue to use ZIPLAB PLUS.
  962.  
  963.                              Jeffrey S. Morley
  964.                            The Interconnect BBS
  965.                                (703)425-2505
  966.  
  967.             PLEASE SEE REGISTER.DOC FOR REGISTRATION INFORMATION
  968.  
  969.                 (C)Copyright 1989-1993 by Jeffrey S. Morley
  970.  
  971.  
  972.